home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / util / cli / shortrel.lha / ShortRel.doc < prev    next >
Text File  |  1995-08-29  |  4KB  |  102 lines
  1. Preface
  2. =======
  3.  
  4.    ShortRel  and  its  documentation is Copyright (c) Short Software, Prague,
  5. Czech Republic.
  6.  
  7.    This  archive  can be freely redistributed as long as all of its files are
  8. included   in  their  original  form  without  any  additions,  deletions  or
  9. modifications  (excluding addition of other README-style files and icons) and
  10. no  more  than  a nominal fee is charged for its distribution.  All copyright
  11. notices  in  the  programs  and  accompanying documentation files must remain
  12. intact.   It's especially forbidden to add various '.displayme' files and BBS
  13. advertisements.  This style of distribution is generally known as FREEWARE.
  14.  
  15.    Special permission is given to Fred Fish to distribute this program on his
  16. "Fish Disks".
  17.  
  18.    This  software  is  provided  "AS IS" without warranty of any kind, either
  19. expressed or implied.  The author is not responsible for any damage caused by
  20. it.
  21.  
  22.  
  23. Description
  24. ===========
  25.  
  26.    ShortRel   loads   the  input  file  (must  be  an  executable),  converts
  27. relocations  (32-bit  to  16-bit  or vice versa), strips debug informaion (if
  28. requested)  and  writes  out  the result.  16-bit relocations use 2 bytes per
  29. each one and 32-bit relocations use 4 bytes.  So conversion of any executable
  30. with  many  relocations  from  32-bit to 16-bit relocations saves 2 bytes per
  31. each  one.   Unfortunately,  many  programs  which  directly  scan  the  hunk
  32. structure  (e.g., Imploder 4.0 or PowerPacker 4.3) don't support these hunks.
  33. If  you want to process a file with 16-bit relocations by any of these tools,
  34. you must convert it by ShortRel back to 32-bit.
  35.  
  36.    The short (16-bit) kind of relocations can be used only if referencing
  37. the first 64KB of any hunk. If there are larger hunks, both types of relocation
  38. structures are created.
  39.  
  40.    ShortRel  also tries to squeeze the hunks, so hunks which has nulls at the
  41. end are shortened.  It does NOT do either hunk merging or crunching.
  42.  
  43.    ShortRel executable is PURE and can be made resident.
  44.  
  45.  
  46. Requirements
  47. ============
  48.  
  49.    Kickstart  version 37 (2.04) or higher and ss.library V5.0 or higher (from
  50. package  SSLib*.lha).   The  Special  Support Library is Copyright (c) Martin
  51. Mares, MJSoft System Software.
  52.  
  53.    Programs converted to 16-bit relocations require V37+ LoadSeg to run.
  54.  
  55.    If you want to see what is happening, try to use Exemine (from the package
  56. Exemine.lha by Martin Mares, MJSoft System Software) or similar tool which allows
  57. to show the hunk structure of executables.
  58.  
  59.  
  60. Usage
  61. =====
  62.  
  63.    ShortRel  can be run from the CLI or the Workbench.  Arguments can be specified as
  64. parameters  from  the command line or as tooltypes from the Workbench.  Also the file
  65. to be converted can be shift-clicked with the ShortRel's icon.
  66.  
  67.    Argument template: "FILE/A,TO,KEEPDEBUG/S,RELOC32/S,NOEND/S,QUIET/S"
  68.  
  69.    FILE/A  -  File for converting.  This argument MUST be specified.
  70.  
  71.    TO   -  Output  file.   If  not  specified,  the  original  file  will  be
  72. overwritten.   Direct  overwritting over the original file is not recommended
  73. before the converted file is tested.
  74.  -=-=-=-=-=-  I'M NOT RESPONSIBLE FOR ANY DAMAGED EXECUTABLES!  -=-=-=-=-=-=-
  75.  
  76.    KEEPDEBUG/S  -  Default  is to strip all debug information from the file.
  77. When this option is on, debug information will be keeped in the file.
  78.  
  79.    RELOC32/S  -  Used for conversion 16bit->32bit.  You'll probably need this
  80. function  only  when  the  functionality  under  V36  (or older) kickstart is
  81. required or when some direct hunk loading software don't support HUNK_DREL32.
  82.  
  83.    NOEND/S  - Don't produce HUNK_END marks between file section.  These marks
  84. there  should  be  but  the  system  LoadSeg  routine  silently ignores them.
  85. Compatible  with  PowerPacker  4.3  but  not  with Imploder 4.0.  Think twice
  86. before  converting  because  these  files  may  not be readable by future DOS
  87. releases (tested with 40.3)!
  88.  
  89.    QUIET/S  -  Don't write the final message about size gain.
  90.  
  91.    If you need to know more about structure of executable files, look at the
  92. documentation of Exemine.
  93.  
  94.  
  95. Final words:
  96. ============
  97.  
  98.    Thanks to MJSoft for the program idea and the ss.library.
  99.    Thanks to Pavouk for the ShortRel's icon.
  100.  
  101.    Send all comments and bug reports to short@k332.feld.cvut.cz.
  102.